AT-A-GLANCEREFEREMCS 



[RETURN] means press the RETURN key,., 

FORMAT A DISK: 
type OPEN 15,8,15 



PRlNT#i5,"NO:youfdl8kname,2 digit Id" 

CLOSE 15 



fRETURN] 

[RETURN] 
[RETURN] 



or 



OPEN 15,8,1 5:PRINT#1 5. "NO:yourdi8kname,W":CLOSE 15 
IRETURNJ 

Walt for light— red Hght— to go out.) 



8CBATCH A FiLEyPROGRAM: 

type OPEN 15,8,15 

PRINT/?15, "SO:name" 
CLOSE 15 

or 

OPEN 15.8,15:PRINT#15, "SO:name":CLOSE 15 

INtTlALIZE YOUR DRrVE: 

type OPEN 15,8,15 
PRINT#15, "I" 
CLOSE 16 

Of 

OPEN 15,8,15:PRINT#15."r:CLOSE 15 
VALIDATE YOUR DISK: 

(newer use «^ a (fisit vH^ ^mdom files) 

type OPEN 15,8.15 
PRINT #15, "V" 
CLOSE 15 

or 

OPEN 15,8,15:PRINT#15,"V":CLOSE 16 

READ THE ERROR CHANNEL: 

type 10 OPEN 15,8,15 

20 INPUT #15AA$.B.C 

30 PRINT A.A$,B,C 
type RUN 



{RETURN] 
[RETURN] 
[RETURN] 

[RETURN] 



[RETURN] 
[RETURN] 
[RETURN] 

[RETURN] 



[RETURN] 
[RETURN] 
[RETURN] 

[RETURN] 



[RETURN] 
[RETURN] 

[RETURN] 
[RETURN] 
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SPECIAL H6TE for reading this guide: there Is a sHght difference between 

a ZERO and an "0" in the text. However, it is of great importance that you 
can recognize the difference (because this is not a dot-matrix printer there 
can be no line through the zero). , 

A ie jt^ a bit thtnna: 

An "O" fe mu<Si more round: O 

It la Important that you study the difference In the two because you will 
need to know the difference as you go through the programs and commands 
listed in the guide;.. 



INTRODUCTION 



Congratulations! You now own a Commodore and a 1541 Disk Drive. 
You've got a great combination. Unfortunatelyi you've also got the VIC-1&41 
U8w'» Mmml and you may b« fhfiding R tou^ to dig out the informaton 
you need, That's what this Survival Guide is here for. Here you can find the 
information you need, in plain English, to mal<e the most of your system. 

You might want to glance through the entire Guide, just to get an idea of 
What's here and where It Is. Don't feel that you have to learn everything at 
(meel The GtJftfe% fafoksn down Into easy»lo-ewaliow plec0S/You 8t^ 
want to do Is load and run your new game disk Giant Space Marshmallows 
Attack Harrisburgl7 Fine. Look in the First Steps - 'Ready-made disks'. You 
want to save the nifty little program you just ran off? That's First Steps - 'Your 
Own Disi('. The stupid little red light is blinking and you don't hav« any idea 
why? Look In Sscomf SMps ' The Bror Channel or Thai Stupid Rod Light 
is On AGAIN!'. It's all here. Relax, 

Another purpose for the Guide was to correct a few little mistakes in the 
User's Marmi, I'll give nAemms to the User's Alwiua/ so you'll be able to 
malce comparisons. 

There's a seetlort here on the \l\Mge program you got with your disk drive. 
I'll give you some reasons why you'll want to use it, as well as « mom com- 
prehensive list of commands. 

You Oietn also find some general information on files. I've Included a sec- 
tion cn vary gsneral trouble-shooting and a bibliography of helpful books and 
drtfdtes. 

Last but certainly not least is the at-a-glance reference listings on the in- 
side of the cover. You can use the listings found there to jog your memory 
of just what to type to Fotmat, or Initlafize or Read the Errw Channel. 

Have fun! 
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SETTING UP 



O.K. You've unpacked youf diakdr^ancfyou 're ready to hook everything 
up. Confident!? If you liave no questions, qualms, or if everything is already 
hooksd up an running properly, move right along to the next chapter. For 
the rest of you, here we go. 

Turn of! all the power to your system and make sure the on-off switch on 
the back of your drive is in the "off" position. You should never plug arching 
into your drive when the power is on. Now look at Fig. i. Plug one end of 
your serial bus cable into one of the serial bus inputs (it doesn't matter which 
one you use). If you have a printer or additional drive, you can plug it into 
the other serial bus. Now plug the other end of your cable into the input on 
the bac^ of your computer (In the outlet closest to the user port). Plug your 
power cable (the thing that has an electrical plug on it) into the power Input 
(It will only go in a grounded recepticle) or your power strip. 

You've done iti Now you can move on to tiie n^ chapter. 
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TECHNICAL JUNK 



One of my pet theories about progranunore is the intultim vs. slruob/re 
iirea^dtvlslon. Intuitive programmers ofteti don*t know or cars how their pro- 
grams work, they just do it. Structure freaks, on the cithdr hand, lowe rules 
and regulations and knowing exactly how and why something works. Users 
of thte guide may also fall into these categories. At the extreme end, if you 
never want to know how or why your drive works, remember this — IT'S ALL 
MAGIC — ; now go on and memorize the commands In the next chapter. If 
you are a moderate member of the intuitive school, this chapter is still pro- 
bably not for you, but you may want to look at the pictures. One the other 
hand, if you ara not corntertsble v«#K)ut a grasp ol th« whys and hows ^ 
your computer " read on for at leiast a minima) grasp of what's going on. 

Ths Diira ttself : 

Your 1541 disk drive is a device for storing information, In magnetic form, 
on a disk (in this case, a bV* inch fk}ppy disk). The information is stored via 
a rwKffvnIte hemd. The read/Wrtte head Is analogous to the play/record head 

in a tape player. 

When you put a disk in your drive and close the door, the drive hub clamps 
down on the center (hub in Fig. 2,1) to hold the disk in place and center it. 
The centering is not perfect, so there is some malformfUion of the disk. This 
ts one reason dislcwith ftub tings or reinforcement of the hutis are desfrabfe. 
The hub ring helps protect the shape of the disk. A pressure pad presses 
down on the disk from above, insuring proper contact with the read/write head 
underneath the disk. Remember when you are handling your disk that the 
infofmatk>n is stored on the underside. The head is mounted on a track which 
permits it to move back andtbrth across the disk as the disk revolves at ap- 
proximately 300 RPM. 

When you read from or write to a disk, the head moves across the disk 
to the proper location on the disk. The Hsmi comes so close to the disk when 
the drive is in operation, that even the oil deposited by a fingerprint is thicker 
them the clearance between the head and the disk. 

You may hear from people who sell head cleaning kits that you should 
use their product once a week. Don't you believe itl Using the kind of cleaner 
which uwe pads hsd been likened to deantngyourieadAvrfte heed witft sanci- 
paper. Imagine the damage a weekly aandpaperfng session would do! Clean- 
ing kits relying on strong solvents can soak your pressure pad with solvent 
and eventually dissolve parts of your disk, Great! A once a year cleaning 
with alcohol should suffice, as should a word to the wise. 

The Dtofc end Disk Structure: 

Your disk is a piece of flexible magnetic tape, much like the tape used 
in a tape recorder. It is contained in a protective covering to prevent damage. 
The read/write head of your drive access^ the disk through the read/write 
slot (see Fig. 2.1). The density of the magnetk: coating determines whether 
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the dlskM ^gb ^sity (thinner coating) or douab/s dmsily (thicker eoatingji. 
The Bt^ength of the magnetic signal determine Whetfier you need slngte or 

double density. Single should suffice for Commodore. If the coating is too 
thick for the signal, the data may not be recorded properly, and you may 
lose data. 

The disk is divided into tracks. Unlike a record which has only one con- 
tinuous track, a disk has many individual tracks. Commodore Disk Operating 
System (DOS) uses 35 tracks. Track 1 is the outermost track, while track 
35 is the nearest to the hub. Track 1 8 holds the Directory (q ,v.) and the Block 
Allocation Map (BAM q.v.). Each track is further divided into sectors or t^ooks. 
The Commodore is able to store 170K (one hundred and seventy thousand 
bytes) on a single density (q.v.) disk by varying the number of sectors in each 
track. Tracks 1 to 17 hold 21 sectors each. Tracks 18 to 24 hold 19 sectors 
each. Tracks 25 to 30 hold 18 sectors each, while tracks 31 to 35 hold 17 
sectors eac^. 

The BAM: 

The letters in BAM are variously given as representing Block Allocation 
Map, Block Availability Map and Bit Access Map. Whatever you decide it 
stands for, the BAM ^ a list of all the blocks/sectors on your disk (683 in 
all). Each block holds 2S6 tiytes. (If you multiply 683 by 256 you get 174,848 
bytss available, or about 170K.) The BAM keeps track of whether a given 
block is in use or not by storing a block of bits which correspond to the 
available location on your disk. By turning the bits on or off (1 -on/available 
or (kiff/unavailable) the BAM keeps track of your available space. The BAM 
is updated rach time s file Is SAVEd or SCRATCHed, or e^^ time n 
file Is cfosed (note difference in directory storage method). 

the DOS stores the BAM in Its memory and goes on its way. If you change 
disks, the DOS is still operating on the stored BAM so that if you try to write 
to the (tew disk, blocks that the BAM says are available, may not be. The 
DOS checks ID numbers before it writes to the disk, so if you have unique 
ID numbers for all your disk, the worst thing that will happen is that you get 
an error. If, however, you use the same ID number on all, or many of your 
disks, the DOS will assume everthing ^-alright and you could end up over- 
writing your files. Unique ID numbeis are a must (eee WhatHm:^§n9 Whsn 
you FORMAT). 

Even keeping this In mind, it's always a good idea to IntOe^ss your drive 
(q,v.) whenever you change disks. 

Directory Facts: 

The directory Is stored In track 1 8 dF your disk. If oonMns the diek Aeacter 

(the disk Name and ID number) stored in block 0. The rest of track 18 con- 
tains the names of all the files on the disk, the file designation for each (PRG, 
SEQ, REL, USB), the number of blocks used by each file and the number 
of free blocks on the disk. You can store up to 1 44 file entries in your direc- 
tory. The dilatory is updal&d avi»y^itJ« a program te ®^Ed or 8CRATCH- 
ed, or when a data file Is opened (note difference in BAM update methocte, 
below).. 
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What Happens When You FORMAT: 

When you FORMAT (or as it is sometimes called NEWing) a disk, you erase 
evdrything ttiar on tha dbk (If It was pmviously used) and get It ready 
to be written to and read from. The Disk Name is stored in track 18, block 
0, and the unique ID number is written to every block on the disk. The direc- 
tory is begun in track 18. Immediately after the disk is FORMATted, the direc- 
tory consists of the Disk Name, the ID number, the ASCII code for 2A (the 
DOS v^rirtbn and fmat ^rp^) and tht nuniber of bloeks free ^64 - the 19 
blocks of tmck 18 ere set eslde tor the heUder and dir»:tO(y}. 

What Happwie When You SCRATCH nies/Dteke: 

When you SCRATCH ftflte the bit in the directory which indicates the file 
type is set to (dsleled). The File Name is no longer listed in a direelEJry 
listing, and the blocke attocated tti fhatfile are conskfered Tree for other nee, 

The file is actually still there, and If the relevant bit can be reset to the ap- 
propriate number (1 - 4 depending on file type) the file can be restored. 

Resurtttettng Flles/Dtoka: 

Files: 

A file can be brought back either by a canned program specially designed 
to unscratch a file, or by gaining access to your disk's BAM and resetting 
the bit that designates whether a file Is determined to be present When a 
file Is SOHATCHed this bit Is set to 0. Setting it to 1 will bring back the file, 
unle^ you have ueed the diek and overwritten parts of the file. 

Dlefa; 

Forget it! Once you NEW or reFORMAT a disk, all the files that were on 
tiiat disk are gone. If anyone out there knows of a way to bring them back, 
I WDutd km w know about K. (By ttle way, tf you can do thea, why am you 
Feeding thte booki?) 



7 



THE FIRST STEPS 



1- Tattling It On 

First, make sure there is no disk In your drive. You sliould never turn your 
drive on or off with a disi< in it, You could ruin the disk. Once you're sure 
the drive is empty, you are ready to turn on the power. The argument con- 
cerning the order In which you turn your components on and off seems to 
bethemoddm equfwttentof noflirmany angels can danwonthehKid of apln. 

One school (including Commodore) holds the computer should always be 
turned on last and off last; another school holds the computer should be turn- 
ed on first and off first. There are other opinions which incorporate both. 
Check for any special Instructions that your printer or interface might have. 
If you have all your components plugged into a power strip or surge sup- 
pressor, everything will go on and off at the same time and saves you the 
effort of worrying. I personally lean toward the computer on last off last school, 
but I can give you no ex-cathedra pronouncement on this subject. 

Whan you turn on the drive, both the green light and the red light will come 
on. [See T&chnical Junk Fig. 2] The red one should go off almost at once. 
The green light stays on all the time the drive is on. The red one Is only on 
while the drive is running. NEVER take a disk out while the red light is on 
and the motor is running. You may want to make a correction in your Com- 
modore 1541 Users Manual, page 8. In the last secton of Insertion of Vie 
Dfskette, cross out green and insert red. If you wait for the green light to go 
out, you may have a very long wait. (Don't read (he next senfe/jce unless 
ffte red light is blinking and you HAVE to remove Uie disk for some reason.) 
^uatty. It's a £|ood idea not to take a disk out of Hie drive white the red 
light is on, but if the red light is blinking to indicate an eror, and the motor 
is NOT running, you can take the disk out if you must, 

2- The Disk and How To Use It 

Your (/ser'sAfanua/ specifies single^ded, single density disks. Most disk 
manufacturers recommend slngte^ided, double density. You can probably 
use either. [See the section Technical Junk for more on density.] 

Disks don't respond well to very high or low temperatures. As a rule of 
thumb, if you're comfortable, so is your disk. When you transport a disk, or 
buy a disk, or get a disk in the mail, it 's a good idea to g tve the disk a chance 
to rest and come to room temperature before you try to ft. A disk that 
won't operate properly when it's cold, may work just fine after it's more com- 
fortable. Never leave disks in direct sun or in the glove compartment of your 
car. 

You should also avoid taking floppy too literally. Try not to bend the disk 
as this can cause the magnetic coating to come off in spots. 

Also try to avoid magnetic fields (such as those generated by mail sorting 
devices and MONITORS and TVs), If you must send a disk through the mail, 
m&ik it for hand cancelling. Never store a disk on your monitor, and if fact 
try not to store them ckiser than two feet away. 



8 



Never write on a dtek With anything other than a left tfp pen. Anything etee 
can leave marks on the magnetic surface of the dtek, 

Once you have your disk, remove it gently from its prstectfivf sleeve, holding 
it by the upper left eomer (as you Joak at itju [Qm Trnhnfm^ Ju^k Fig,. 2,1 
for fflom fnfo,] there ts a notch fn the tfght side, Thfe fs the *Vff(e ^^fee! 
notch. If there is tape over this notch you cannot write (save) anything on 
the disk. A small digression: You should never actually write anything on 
your disk. Us# I^Jt tip pens to mark on your label. Now, still holding the up- 
per left com«, gently Ins^ the disk, with the lab^l up, in the insejiian slot 
on the front of your disk drive (whlbh Is a/reac^tumed on). [See Tec^fea/ 
Junk Fig , 2 .] NEVER force a disk. Once tiie disk is in place, shut the disk drive 
by pulling down on the latch until it clicks shut, or in newer models, turning 
a ktch. Fine, now you're ready to go. 

In 01B fokawing sectiom the word file will be used where ^ti e^cpect the 
«OFd jscogram. This fs becaiae a program fe a Wnd oP fite, 

A Ready-Made Disk 

Bf mmfy-'made or used disk, I mean a pre-packaged disk that you have 
pur#iif8e«I (^■•g0m-m a data l^se of Vtm Wney-om that is alr^y tenmaf- 
ted and has something m it, 

(a) LOADing a dlrectoiy 

This means that^you want to put into your computer's memory a Itsfng of 
ail thfi 'Btes available on a diyk. Once you see the directory, you can decide 
What file to put in memory. You may notice thai each of the file names has 
a number in front of it and a three-letter code following it. The numbers are 
the number of bloeks taken up by the file, and the codes indicate what kind 
of file it fis. The codes are PRG (program file), SEQ (sequential ffle)^, USR 
(user file - identical to SEQ file}, and REL (relative file). Programs (PRG) are 
the only files which can be loaded directly, so in the following sections, when 
you see file, it's probably alright to think program. The other types of ffles 
(SEQ, REL, and USR) are all cteita files (they hold data, not an actual pm- 
gram) and can only be loaded through a PRQ file. We'll talk more about this 
later. Some pre-packaged disks have loading instructions so that it's not nec- 
cessary for you to see the directory. Some disks are even protected so that 
you can't see the directory. BtJt aasuming both that^u want 10 and can, 
jfiere's how you do It. Type: 

LOAD"$'',8 [RETURN] 

Your computer Will respond with: 

SEARCHING FOR "$" 

LOADING 

READY 

If you see something different, you have a problem. (See the Trouble-Shooting 
seetton). Once you see "READY*' j^u im "UST'i "RETyRl^**, and 
your dir^tpry will be printed on yo^ir s£*©eh. 
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(b) LOADing a file 

This means entering a file into your machine's memory so that you can 
use it. This is what you do. First you choose which file you wish to load 
(hereafter referred to as name cfyour fte - remember you type the ai^jal 
name of the filel). Then type: 

LOAD"name of your file", 8 [RETURNI 

Your computer will respond with; 

SEARCHING FOB "name of your t»e" 

LOADING 
READY 

If you see something different, you have a problem. (See the Trout^eShoo^g 
section). Once you see "READY" you can do three things (actually you can 
do many more, but let's not get philosophical); you can VERIFY the file, LIST 
th0 fild or you can BUN ttw fHe. 

(c) Verifying a flte 

When you verify a file you've Just loaded, you compare tfie fite in memory 

to the file on your disl<. If they are not identical, you will see VERIFY ERROR 
and you will know something is wrong. To verify a load, type: 

VERIFY"natm of your tile' ' ,8 tRETURN) 

Ths computer wilt respond with: 

SEARCHING FOR name of your fife 

VERIFYINS 

OK 

READY 

(d) LISTIng a PRQ fife 

If you want to see a listing of the PRG file, afid [fie file will let you (and 
for a number of reasons a ready-made file may not) you can type the 
oommandt 

LIST (RETURNI 

The lines of your file will now scroll past you On the screen. We'll talk more 
about LIST in the next section. 

(e) RUNning a PRQ IHe 

If everything h9s gone well up to now, you are ready tor the big plunge. 
Running your fffel When you give this command thd compi^f looki^ at 
whatever is in its memory (and you ve just put your file there) and follows 
the commands of the file. So you type; 

RUN [RETURN] 

and youVe off and running. (You are, aren't you?) 



10 



4' Your Own Disk 

Now we're talking about your very own dl^*^ Maybe it's right out of the 
box Emd hias never been u^d. M^^be tfe gotsemve of your mo^ pi^ious 
files on it. Let's see vthat we can do with it. (Piease read Section {&). It's 

really important!) 

(a) FORMATting a disk (or The First Time) 

{Additional information on the process of FORIVIATting and the disi< itself can 
be found in the section Technical Junk.) 

When you take that nice new disk out of the box, it's not ready to be used. 
Beibre a disk can be used, you must FORMAT H. When you PORMAT a disk 

you give it a name and identification number. The identification number can 
be any two characters and should be unique for each disk. (You might want 
to use ID numbers that reflect what is on the disk. You could start all the 
IDs of game disks with a G, or all utility disks with a U, etc.) The Identifica- 
tion number (ID #) is written on each sector of your disk. The formatting pro- 
cess also sets up a directory for your disk. Once there is a directory and each 
sector has been identified, your disk is ready to use. To format your disk, type: 



The red light wilt go on and your drive will start to make noises. The READY 
prompt will appear on your screen, but the red light will stay on. The disk 
is not formatted until the red light goes out. Your disk should now be ready 
to use. You only need to format a disk the first time you use it. If you re- 
format a disk, everything that was on it before will be loat, sowevw re-format 
a disk unless you want to erase it. 

Wetl, what dan you do with your formatted disk? The ^ Ihing you might 
want to do is LOAD tfie t^mctoiy to make sure everj^hins is alright 

(b) LQADing a direetory 

Loading a directory means that you put into the computer's memory the 
name and /D#of your disk and a list of all the files flf any) on the disk. Whether 
this is an empty disk, or one that you have filled vrtth files, the process 
loading a directory is the same. You type: 



Your computer will respond with: 

SEARCHING FOR "$" 

LOADINS 

READY 

If you see something different, you have a problem. (See tiie Troubleshooting 
sectkin.) Once you see READY you can ^pe LIST, F^TURN, and your dIreOo 
tory wiH be printed on your screen. 
You can mm tinexm a PRGi ttle fMm the dft«ete»y to load Mo memory . 



OPEN 15,8.15 

PRINT#15,"NO:DISK NAME» ID#' 

CLOSE 15 



IRETURN] 
[RETURN] 
[RETURN! 



L0AD"$",8 [RETURN] 
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(c) LOADing a file 

LOADing a file means getting a file from some storaQsct^ice (in this case, 
a disk) and li^tefetrlng the Insmn^one Mo your machine's m^rtory eo 
you can it. Here is what you do. You have already chosen your file (se» 
aedlon S^b). Hereafter we will refer to it as name of your file although ^u 
type the actuai name of your file. Ttien t^: 

LQAD*«nanf»ofy»)urfiie",8 [RETURN! 

Your computer will respond with: 

SEARCHINQ FOR "name of your file" 

Lomm 

READY 

If you see something different, you have a problem. (See the Troubleshooting 
section,) Once you see READY you have some choices: you can VERIFY 
the file, UST file or you can RUN the tile. L^t'a see what those cholera 
mean. 

(d) VERIFYing a file 

When you VERIFY a file you've just loaded, you compare the fite in memecy 
tdthe flie on your disk, tf they are not fdentlcal, you wll see WR^YB^^ 
and you will know something is wrong. To verify a load, type: 

VERIFY"name of your ttlB",8 [RETURN! 

The computer will respond with: 

SEARCHING FOR name of your tile 

VERIFYING 

OK 

READY 

(e) Listing a file 

If you want to see a LISTing of the PRG fiie currently in memory, you can 
type the command: 

UST tRETURNl 

The lines of your flte will now scflsl p&Bt you on the screen. To slow this scroll- 
ing, press the control key. (That*s the key marked CTRL.) If you want to see 
only part of a program you can request sections of the program to be listed, 
if you want to see lines 10-50 (for example) type; 

LIST 10-50 

If you want to see all the lines up to line 100 (for example) type: 

LIST -100 

if you went to see ail the lines after 1^0 (e^n, m. an memplxi^ type: 

LIST 100- 

You can ^en maite correotlonsT cheotc syntax or whatever you wish. 
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(f) RUNning the PRG file 

If everything has gone will up to now you are ready for the big plunge. 
Run your file! When you give this command, the computer looto at whatever 
Is in ttB memory (and you've Just put your fHe there) and follows ^e oom- 
nmnde of the fUs. So you type: 

RUN [RETURN] 

and your program beginsi There, wasn't tttat easyl? 

(g) SAVElngalWe 

If you have entered a program, either by hand or from some other storage 
source (e.g., disk or tape) and wtsh to keep a copy on the disk now In your 
drive, you can use the SAVE command. This command makes a copy of the 
program in your machine's memory onto the disk in your drive. You decide 
what you want to call the file (in our example we'll use "your file name" but 
you use the actual name) and then type; 

SAVE"your file name",8 

Your 64 will respond with: 

SAVING your file name 
READY 

You can't save two programs with the same name on the same disk, If you 
want to save multiple copies of the same program, ycu must give the files 
different names (e.g. PR0GRAM1, PR0GRAM2, etc.). 

You can VERIFY a save justaa you would a load by following the instruc- 
tions glcmt be^fxa. In ttila case 9m verify eheoks to see if the program has 
been saved as wrritten. 

(h) SAVE and REPUCE (8AVE®(9 

The command SAVE@0 replaces a file with a new version (with the same 
name) by making a copy of the new file, and then SCl=^TGHing the old file. 
Your Commodore User's Manual says you can use a command ^VE@0: 
to rave and replace an already exteting file with tfte same name. Yes, you 
can, but... 

There is an ongoing debate In the Commodore community concerning this 
command. One school holds that you run the risk <rf knlra one or both files, 
or in extreme cases, the entire dlslc If you useSAVE®0. Trtere Is, reputedly, 

a bug in this command which makes tt risky to use and sometimes causes 
it to replace the wrong file. If you want to follow this school, scratch your 
file and resave K. (Look in the next chapter under SCRATCHIng a file for help.) 

Other Commodore experts swear that SAVE^O Is complelely sate^ and 
that praUems allegedly stemming from its use can always be tn»ed to other 
causes. Even this school admits that SAVE® cannot be safely used if there 
is not enough room on the disk for both the original and the replacement 
to exist at the same time (which is what happens before the first version is 
erased). That is, If you only have 10 blocks free, don't try to use SAVE@0 
writh a fife that Is 2Q blocks long. 

When you feel comfortable with the commands In this sooton, give a look 
at Ihe next chapter - Second Steps. 
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SECOND STEPS 



Now that you have the basic moves down, you can think about some of 
the more advanced things that you and your disk drive can do. In this chapter 
we will took at ways to send ^ur programs to a pitntert erase a file, read 
your error channel and more. As in the last chapter, the name "your file 
name" will be used in the examples, where you would type the actual file 
name. Rr^ let's look at t\m to remove an unwanted file. 

Section 1: 

(a) SCRATCHing (erase) a file 

SCRATCHIng afile, in effect, erases a file from your disl<, although in fact 
what it does is erase Vne mrm of the file from your directory. (See Technical 
Junk for more on tK»v the dincfory works.) When a file is s(^ched, the 
number of bloct^ frm ^ Inoreased by fie number of blodcs tfiat were fin \h» 
file. When you see [RETURN] press ^6 key marked RETURN. In onler to 
scratch a file, type: 

OPEN 15,8,15 [RETURN] 

PRlNT#l5,"SOiyour Hie name" [return] 

CLOSE 15 [RETURN] 

The drive will make some noises and the red light will come on while the 
program name is erased. Be careful when you scratch a file, a$ It is vwy 
difficult (often impossible) to restore a scratohect file. 

If you wish to save a fUe and replace an aireAdy exfeting file vrith the samo 
name, SCRATCH the file on your disk using the procedure given alXJVe, then 
save the new file. This will avoid the problem with the SAVE@0: command 

In the following sections we will lool< at ways to change the name of an 
already existing file (RENAME) make a copy of an already existing file (COPY) 
or combine two to four files (MS1GE). 

(b) RENAME a file 

If \«)u wish to change the name of a file on your disk, this is the command 

for you. One word of warning: This command does not work on an open file, 
so wait until you close your file to rename it. In our example the terms oldname 
will stand for the current file name and newname will stand for the new name 
you wish to give the file. Now, taking ail that into consideration, this is how 
you f^NAME a file. Type: 



OPENIS.e.lS 

PR INT#1 5 , " RO:newnaffle50:oldname** 
CLOSE 15 



IRETURNl 
[RETURN] 
[RETURN] 
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(c) COPY a fne 

This command will make a copy of a file on your disk. It will not copy from 
one drive to another unless you are using a dual drive (such as a 4040 or 
MSD dual drive), tn our example, newflte will be the name of the copy and 
otdfile the name of the file to be copied. You will, of courea, enter the actual 
names. Type: 

OPCNI 5.8,1 S [RETURNl 
P Rl NT#1 5 COtnewflle = O:oldflt©" [R ETU R N] 

CLOSE 15 [RETURN] 



(d) MERGE two or more files 

The COPY procedure can be used to copy two to four files into one new 
file. Whm you use this proceduro, make sufs tfiat the files you are going 

to merge don't have overlapping line numbers, as this can really make life 
difficult for you. If you find that there are identical line numbers in the pro- 
grams you wish to merge, renumber one or more of the programs using either 
a programnDer's aid such as VIC Tree or Simon's Basic, or gel a copy of 
one of the Pubtio Domahi renumbertng utilities from your kx^ user group. 
Once you have checked the line numbers you can proceed to MERGE the 
flies. Again, our example will use nsH^ffis as the name of the copy you are 
creating and o/dKMs (to a maximum of foui) as the name of the files to be 
copied, Type: 

OPEN15,8,15 [RETURN] 
PRJNT#15,"C0:newflle -O:oldfilel ,oldflle2, 

oldfile3,oldfile4" [RETURN] 
CLOSE IS [RETURN] 



Section 2: 

The next two commands we will examine don't do anything to a particular 
Hie; biased ^ley enable you to otoan up a disic (VaBdate) or to return the 
drtva to Its start ip condition (inHl^ize). 

{a)VAUDATEadlsk 

There are number of reasons you might want to use this command. If you 
have been using a disk for a long time and have erased a number of files, 
you will have small groups of blocks here and tfiere which were too small 
to be of any real use. The VALIDATE command will clean up the disk by 
causing the drive to search the disk for these unused blocks and making 
them available to you. You may be able to increase the blocks available by 
a considerable amount by VALIDATING. Another time to use VALIDATE is 
when a file will appear in the directory with an asterisk (*) in front of the file 
type (PRG, SEQ.USR, REL). Improperly closed files can cause problems with 
all the information stored on the disk. You cannot SCRATCH such a file 
without rlsi(, but VALIDATING the disk will remove it. To VALIDATE a disk, 
type: 
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OPEN15,8,15 [RETURN] 
PRINT#1 5," VALIDATE" [RETURN] 

{instead of VALIDATE, yoy mn Use PR1NT#15,"V") 
CLOSE 15 [RETURN] 

(b) INITIALIZE 

This command returns your drive to the sam@ condition as when you turn* 
ed ft on. INff IALI2E clears the error cfiaittiet (this is one way brides reading 

the error channel (q.v.) to get that8bi|dd red light to stop flashing!), and if 
used every time you switch disks, win pievent any possible confusion caus- 
ed by different BAMs (block allocadon maps on your different disks. 
To INITIALIZE your drive, type: 

0PEN1 5,8,15 [RETURN! 
PRINT#1 5, "INITIALIZE" [RETURffl 

(instead of INITIALIZE, you oftn use PHINT#15."l") 
CLOSE 15 tRETURN] 



Section 3: 

Now let's look at some things you can do which involve opentAigi c/ranne/s 
to other cofliponenfas. iiher ^r drive or y^r printer. 

(a) Reading the ERROR OiANNEL, or "Thrt Stupid Red Light Is Flashing 
Againt" 

When there is an error condition, for example, a read error, or the file you 
are trying to access is not open or any of a number of problems (see pp. 
43-46 of your User's Guide), the red light on your drive w|ll start to blink rapidly. 
Unfortunatefy, metis is no Irrmtedlale way fo know why you are getting tfie 
error tight. What you need to do now is read the error channel. This means 
opening up a channel (channel 15 is reserved for error messages) and ask- 
ing the computer for information regarding the error. You open a channel 
by using the command OPEN followed by a file number, a device number 
('8' for your disk dflve, '4' for your printer) and a diannel number. Usually 
one mal<es the channel numlwr (Which can beany number from 2 to 14 - 
0, 1 , and 15 are reserved) the same as the file number. You will see this 
structure in the sample program below {look at line 10). 

If you are not using your Wedge (q,v.) this program will get you the infor- 
matbn you need. 

10 OPEN 15,8,15 
20INPUT#15,A.A$.B,G 
30 PRINT A,A$,B,C 
40 CLOSE 16 

The four pieces of information you get are (A) the error number (refer to pp. 
43-46 of your User's Guide for additional information about the errors), (A$) 
the error name, (B) the track number, (C) the sector/block number (see 
Tachmoai Junk for further exptanatk>n). If you don't care about the track or 
eeolor. yotjcw ]u8l reqiwst theliffliira^piemof Infof^^ (Aand A$). 
You now know your probtem and take the appropriate steps to correct 
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it. fiUm the red light is off. 

As an example, suppose you tried to save a file anslsiick3enly the red light 
started blinl<ing, indicating a problem. You have no Idea what's wrong, You 
lool< at your program and see nothing obviously wrong. Here's what you do. 
Let's say our imaginary program starts with line 10. You then enter an ab- 
bre^ated femt fBTTteririg ©nly the ttrst two varta&la^ of pmgmm on p .22, 
beginning your line numbers with 1 rather than TO. You also add line #5 END, 
This numbering prevent,s you from overwriting the program, and the iine 5 
stops the program a.s soon as i:lne relevant information has been obtained. 
You RUN the program and get the information, 63 FILE EXISTS. You would 
(mow that vtiu were trying to use tfie name of an already ex^inig file end 
you could try and SAVE your program again under a different name. 

If you want the red light off, but don't care what the error message is, IN- 
ITIALIZE yeiur drive, {§&b previous aeoflon for dfrestiofm.) 

(b) Opening a chawtiel to your printer 

If you went herd oopy, or a printed Mnf§ of your program, you 
tell the computer to send the output to your printer rather than yourss^aa. 
The following command will do just that (compare with the incorrect Insil'tflh 
it0fis on p. 11 of your U8Bf $ Qu!(39): 

To return OOrttfot to your screen, type: 

PRINT#4:CLOSE4 [RETURN] 

There is no logical reason you should have to type PRINT#4 before you 
mn dom the cl^nnel, tmt iruat me, you do^ 

Section 4: 

The last section of this chapter will explain Wild-Card or Pattern matching, 
how to make a backup copy of yourdia^s, ^d howto^py fifet feefeft/een dlsl@ 
and between disl( and tape» 

(a) Wildcard or Pattern Matchfng 

T>»r»ai«tsw wiW-ce/irf symbols used in matching - '*' and '?', By using 
a M^te^iE^rEl' syflfife©!, you can save yourself some typing by having to type 
only part of a program name to LOAD a program. For example, typing 'LOAD 
"P*",8' would load the first progam on a disk whose name began with 'P". 
Typing 'LQAO •'0'.*",8' will automatically LOAD the first program on i dtak. 
As long as you give enough of the name to make it unique, you can use pat- 
tern matching. You can also use pattern matching to SCRATCH file, but use 
it with caution so that you don't scratch more than you wanted to. for exam- 
ple, the other night my husband typed 'SCRATCH "*.DAT"'. What he meant 
to do was scratch all the flies ending with a .DAT m0\Q (our way of 
designating data files); what he did instead, wa@ erase every nle on the disk,; 
and it took a LONG time to get them back! 

The other wild-card symbol, '?' can be used .-if' lin a file name when you 
are unsure of the entire name, or when you want to list a directory of only 
certain ffies. Per wampla *tj@A0 "B'ilL"0 eeaWtoad fjlgs^ ealletf **BILL^ 
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"BULL", "BELL", etc.. Typing 'LOAD "$0:F?LL",8' would load a direc- 
tory of any programs on the di.sk whose four-letter names began with 'F' and 
ended with 'LL'. On the other hand, 'LOAD "$0:F?LL"',8' would load a direc- 
tory of all programs with names of any length whose first letter was 'F' and 
whoM third and fourth letters were 'LL'. 

(b) Making a backup 

Why would you want to make' a backup? Wetl, dfaks are not Inde^ruct^ 

ble. They are subject to w&ar and tear, heat, dirt, spilled cokes, cats and 
children. There's no excuse for losing a valuable disk when you can make 
a copy of it yourself. 

To make a backup copy of an entire disk, you need a copy program. There 
are several good ones available through public domain channels. Some of 
the most popular are 1541 Backup (reliable but takes up to 30 minutes for 
full disk), fl 24 File Copier (faster and gives you the option of copying idividual 
files) and Four Minute Bacl<up (just as flW name implies, but can be scary 
to use), There are also copyrighted programifrSuch as Clone Machine, Super' 
copy 64 and The Jolly Roger whfch copy even some protected disks (for a^ 
chival purposes ONLY). There are many more programs both in yourfavorlte 
store and in your user group library. Get one as soon as you can. 

(c) Disk to Disk Copy 

To copy a non>machine language pfogram from one disk to another, sim^y 
LOAD the program ihtoyour machlmmenrrofy in the regular way (See LOAD), 

remove the first disk (source), insert another formatted disk (dastlnatton) and 
issue a SAVE command (See SAVE). There, all donel 

To copy a machine language program, you will either need a program 
spectficaLLy designed to transfer mis^hine laitguage programs or a program 
wfifch edtews you to specify fHcHi t@ bd oa^rfed. 

(d) Tape to Disk Copy 

To copy a non-machine language program from tape to disk, LOAD the 
program from tape into you machine memory as you normally would, insert 
a formatted disk and Issue a SAVE command (See SAVE]. Reverse the pro- 
cess to save from disk to t^a. 



THE WEDGE 
AND HOW TO USE IT 



Many of you will have come in conlact with a utility referred to as the Wedge, 
or In your 1541 manual p. 14 as the DOS support system, either from your 
demo dfak, your Disk Bonus Pack or your usef group (you am ih a mer group 
aren't you!). This utility loads in above BASIC memory (it wedges itself in 

- clever huh?) and lets you use all the commands you are now familiar with; 
LOAD, SAVE, COPY, FOraMAT.etc.. The Wedge gIves you anew (xsmmand. 

- LOAD and RUN. 

The Wedge ateo lets you loofcatyour direetory wKhcut o^j^efwriting the pro- 
gram currently in memory (called a non-destructive load, since it doesn't 
destroy the program in memory). Another bonus of the Wedge directory is 
that you can /Sneeze the listing by pressing the space bar. Press it again to 
resume the listing. In addition to your regular directory, you can get partial 
listings using pattern matching. You can ask ftif a particular file, or all files 
which fulfill a particular condition. If, for example, you want a listing of all 
the files starting with A, enter @$:A. To find, as an example, a file called 
"sarnpfeidat", enter @$:8ample.dat. If you wanted to see if your disk con- 
tains, say, the files "sample", "samplel", and "sample2", enter 
@S:sample*. 

Many people don't use their wedge because, surprisingly (or maybe not), 
the documentation for using it is poor. If you don't hav? a copy of the wedge, 
try and get hotd of one of die publlo 4mBJtn (xxkm^ 

Once you get your copy, you may want to iraMiSrtt to other disks for con- 
venience. When you do this you will note that the Wedge program is in two 
parts; the Booter (which may have boot in its name) and the actual Wedge 
program. On the Disk Bonus Pack these programs are called, respectively, 
&<M W9d|^ithdObS^.f. C-t4\A^gei8lhe-6o^, apna^m wrWenin 
BASIC which you load and run and which loads the wedge for you. If you 
don't wish to use the booter program, you can activate the Wedge by enter- 
ing these fines In direct mode. 



The Wedge is written In machine language (which is why you use the ,8,1 
to LOAD it) and is acSvated by a system (SYS) command (in this case SYS 
52224). If you exftlhe Wedge for some feason, and later wish to tmBM» 
it, you can enter 8V8 62224, [RETURN]. This will reactivate theWw^geUhless 
you have turned off your machine or loaded in another machine language 
program which has interfered with the Wedge, 

The tgsA that tiie Wedge is a madiine langua^je pmQJwm leads to a pns? 
'Nl^ foryou ff you vivaitiolraneferifie^iodg^td mo^erdi^ YducMiiict 
copy maicdilne language pro^tpatn stmpiy by LOAOtng ft and SAVBng tt to 



LOAD "D0S5.1",B,1 
NEW 

SYS 82224 



[RETURN] 
[RETURN] 
[RETURN] 
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anottier disk E^you can a BfiStC pmstmn, Ydu wHI need a pfogram wMch 

aflows you to copy individual files from a dltk. Such prc^rams are reEuJily 
available from public domain sources. 

So now you have your Wedge and it's ready to run. For your convenience, 
( will now offer you a handy reference pjide on using your wedge. On the 
next two pagas you will find a comparhMn betwaerr BASIC and tlia 
In one column 1 wfll list the syntax of the command as it is In MSjC; In Sie 
other column f will give the equivalent using the Wedge. 



DOSWEDOE 



BASIC 



COPY; 
@C:nawf1le<«o4dflle 



OF»EN 15.8,15 

PRINT#1 5,"C0:rYewflle=©1dff1e' 
CLOSE 15 



FORMAT: 
#N:dtsk namejd 



OPEN 15,a,15 
PRlNT#tS/'NO:disk name.id 
CLOSE 15 



INITIALIZE: 



OPEN 15,8,15 
PRINT#15,"r' 
CLOSE 15 




LOAD "program nanne",S 



(machine language 
progmrna) 

%program name 

LOAD and RUN 
program name 



LOAD "program name' 
RUN 



LOAD "program name 



",8.1 



READ DIRECTORY: 



LOAD "$",B 
LfST 



READ ERROR CHANNEL: 



OPEN 15.8,15 
fNPUT#15AB$.G.D 
PRINT#15,A,B$,C,D 
CLOSE 15 



RENAME: 
@R:nawname = oldname 



OPEN 15,8,1S 

PRiNT#15,*'R0:newname = oldnama' 
CLOSE 15 
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SAVE: 

program name SAVE "program Tfame",? 

SAVE & REPLACE: 
(* see note below) 
©program name SAVE "@0:program name",8 

8CBATCH: 

@S:prpgrafri name OPEN 15,8,15 

PRINT#15,"SO:program name" 
CLOSE 15 

Also note: @Q will terminate the DOS Wedge program. 

The symbol can ba eubatKuted for @ irr any of |he Wectge oommsMid$. 

You can also adjust the speed of your 1541 to accommoctf^ eitlier a &64 
or a VIC-20 with the following oommand: 

ForC-64 @UI + 
ForVIG @Ut~ 

* The SAVE@0 command in the Wedge is subject to the same debate as 
Its regular DOS oomtimfmi* If you have not done so, read about SAVE@0 
(pp. 18-19). If you want, you can SCRATCH the file and re-SAVE it in two 
separate operations. Instead of using SAVE@0. 
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FILES 



Since this is a guide to ypur DJsk Drive and not a guide to file programm- 
ing, tie inibriDa^n In tftteebsptar somewhat«^9i^. Addftfonral tn^ 
formation sources on files and file handliiig are listed In Onaptor 8 - 'Addi- 
tional Reading.' 

Your Commodore stores information on your disit in the form of files. Files 
are either p/pgiram file$ or dsfa files. Files are identified by filenames of up 
ta 16 chareKiters. No two files on a single disk cm have idenficat names. 
fin example of^a program file would be a BASIC pn^ram which you have 
SAVEd to disk. This kind of file can be accessed by the normal DOS com- 
mands you have been studying. Data files hold information which is access- 
ed either sequen^Uy (as in Random or Relative files). Data files cannot be 
manipulated by the nontval LOAD and SAVE commancb, but rather have their 
own special syntax. 

A data file is often likened to a file cabinet, where the ^le Kself Is theoEiblnet 
the records or entries are the information folders, and the flek/s Which hold 
the Information are the papers stored in the folders. 

Sequentol FUaw 

In a sequential file, data is both read and written in order, that is in se- 
quence, information is written onto the disk from RAM, through a buffer, one 
byt9 at a time, and read t»ok fM eame way. in order to reach record #7, 
lor example, you must search through records 1-6. 

The general syntax for opening a sequential file is: 

OP£N flle#,deylce#.ohann0li,"O:fllenBme,iipe,dfrsoaoh" 

Here's an English translation: 

file# - the number by which you will refer to tiie file. 

devlce# - 6 for disk drive; 1 for tape. 

channolf - a number fitwn 2 to 14 iremember 0.1 , & 1& are 

reserved). Often the same raimber as tha ftle# to 

help prevent confusion, 
filename - the unique name you assign to the file, 
type - the kind of file (in this case, sequential), 

direction - either write (data to disk - can be at^raviated to W) 

or read (data from disk - can be abbt^ated to H)* 

Information is sent to a sequential file by the PRINT# command. This com- 
mand operates Just like a regular PRINT statement except it sends the infor- 
mation to the drive. Information is separated by what is called a dellmator 
or terminator (a comma, semi-colon or carriage return). Information Is retriev- 
ed from a sequential file either by the iNPUT# or GET# commands. 



22 



Random Access Files 



The two types of random access flies operate differently from sequential 
flies. VW^ remdom msoess files it Is possible to go dliectiy to the desired racord 

without going through the intervening records, for example, we could go 
directly to record 7 (and collect $200) without bothering with records 1-6. 



Relative Files 

Relative files can be thought of as a file whose records are sequentiQj fit^. 
When you Inlttelly set up a relatfve ftfe you must specify how long the leoofti 
is going to be (up to 254 cfiaracters). You may place up to 720 records on 
a disk. The general syntax for setting up a relative file is: 

OPEN file#,device#,channel#,"filename,L," + chr$(x) 

Again, in English: 

file# - the number by which you vM refer to the Hie. 

device* - 8 for disk drive; 1 for t^e, 

channel* - a number from 2 to 14 (remember 0,1 & 15 are 

reserved). Often the same number as tfie flle# to 

help prevent confusion, 
filename - the unique name you assign to the file. 
,L, - indicates a relative file is being created - omit ,Lf 

when accessing a previously created file. 
Chr$(x) - the value of x determines the record length (up to 

254) - only specified when initially creating file. 

To access an already created file the syntax is: 

OPEN me#,devlce#,channel#,"fHename*' 

To access a refative file you must first open the error channel (q.v.), then 
tell the DOS which record you wish to access, by specifying the file (by the 
channeil# as given in ttie OPEN statement), the record within the file and 
where in the record you wish to begin. (Sigh!! ConfusmI? I told you this would 
be sketchy. Read some more detailed articles.) 

Once you have accessed the file, you can either read from or write to fte 
file with PRINT*, INPUT*, and GET*. 



RaiMlnn FHBt 

Random fites are more complicated than either Sequential or Relative film. 
With Random files you take control of the information away from the DOS. 
You specify which trach and sector each piece of data will be read from (block 
read command). You Keep track of which biooks are allocate.d blocks to be 
used again (block free command). Random flies ars not incfuded In the disk 
dtrecloiy. it is generally not advisable to put ai^^iin^etse on a disk which 
Will be used for Random files. Because of their eompl^%, I strongly recom> 
mend you postpone using Random fii^ to later onin your computing career 
(if emt). 
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TROUBLE-SHOOTING 



This Chl^r will offer some suggestions an fUJWto ffxsome problems you 
may run inlo, ft isn't meant to be a maintenance manual. Tliere are several 
of those on the market and if you are at all handy , I would advise you to 
get one. Repair costs average about $50 per hour, so you can save Ug bucks 
if you can do a littte work yoitrtolf. Now - is^iofc to our hiipful tilnte. 

All-Purpose Hint #1 

First, when confronted by a problem with your drive, assume it's something 
flxatole and not a total disaster (there's plenty of time for panic latw)* Thw 
nmm check. all your aqulpment before you start screannir^. Be sura your 
system is ail turned on, that the connecttons are tight, etc.. Thfe amy seem 
silly, but more than one peron has gotten a device nofpresenffiRw simply 
because the drive was not turned onl If, after you have checlted all the con- 
nections, you still have a problem, shut off the system and start everything 
up again. Still have a problem? Don't send your drive back to the store yet. 
Try it with a friend's computer. If it works with theirs, the problem may be 
in the compu^, not the drive. 

Atl-Purpose Hint §i 

Qenerally, my philosophy of life is "If ft'a not bw^en, dont fix it.*' 
Somatlmes with disk drives, this may not t)© a good idea. Your drive can 
and will get out of alignment. This is a gradual process, often so gradual 
that you may not know anything is wrong. Disks prepared on your own drive 
may not present protilems for you until your drive becomes seriously slok. 

If you are darting lo have probleinawifh diisks not prepared on your drive 
(ie pre-recorded disira or a friend's disk), but not your own, try realigning your 
drive. Often this pfwerittve mekiW^ce will correct your problem. 

Device Not Present Error 
(See All-Purpose Hint #1} 

Loatf Errors: 

If you are having problems LOADing a particular program after you are 
sure )}ist availing is as it should be with your equipmetH, there are several 
ftirt^^u can tjy. Cheek your syntax. Make sure you gave ths LOAD com- 
mand properly. Try to LOAD another program. If it LOADs properly, the pro- 
blem may be in the software rather than in the drive. Try to LOAD the pro- 
gram on a friend's mactiine. If it LOADs properly on another machine, make 
a bacltup of it on your own drive (if it's not a protected disk). Sometimes the 
dUterenoBs in speed betvyeen drives ifiterfere «dth a program LOAOtng. For 
@£ampte, i took back ^rea copies of one particular game before I solved 
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my problems by making a backup on my own drive. I never could get a store 
copy of that program to work on my drive! 

You may also experience LOAD errors if you try to LOAD a file from a disk 
with an improperly closed file (q.v.). It this is the problem, VALIDATE the 
disk (q.v.) and agsdn. 

Save Errors 

First check to make sure there is no write protect tab covering the notch 
in the upper right-hand corner of your disk. When that notch is covered, you 
can't SAVE anything to that disk. Make sure there is not already a program 
on ttra^Sk with the same name as the name you are trying to give your pro- 
gram, if you are using the Wedge, you can do this by typing "@$"; other- 
|tfflt try to SAVE the program again with a different nime (e.g., "pro- 
9PafnnaiTie!"inslead of "programname"). Don't check your directory undless 
you ar» i|^g the Wedjge {or somethir^ like it) or you will overwrite your pro- 
gram and (ose It. Cheek your syntax. Be sure you gave the eoinmand pro- 
perly. Check to see if the disk is full (0 blocks free). Again, tf you're not usifig 
the Wedge, don't load a directory, just try another disk. 

Verify Enom 

If you get an error when you VERIFY the LOAD of a program, type NEW 
and try again. If you still get an error, it means the file did not LOAD proper- 
ly. (Refer to the section on LOAD errors.) 

If you get an error when you VERIFY the SAVE of a program, check to 
makB sura ifift pK^eam does not ham any viBtele mm. Chdck you con- 
nections, and try tite SAVE again. If It stll! does not VERIFY refer to the sec- 
tion on SAVE errom. 

File Not Found 

This means either you typed the name of the file incorrectly, you don't have 
a file by that name on your disk or, if you are using a dual drive system, you 
may have requested the wrong file, or If you are using multiple drives, the 
wrong drive. 
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ADDITIOMAL 
READINGS 

ThiB t8 a currerrt (10/84) listing of articles from RUN. Ahoy!, COMPUW 
and COMPUTEI's Gazette which may be of interest to disk drive users. 1 have 
also included a list of bool<s which may be helpful. This list does not con- 
stuttute m endorsement of any magazine or book, and Is intended only to 
be a guide, not a definitive fistina. 

Booita 

L.R. Carter and E. Huzan, Teach Yourself Computer Programming with thB 
Commodore 64, Hodder and Stoughton, Sevenoaks, Kent, England, 1983. 
American publisher: David Mcl^y Co., Inc., fim York, New York. 

David Millerer, CommodoTB^ Data t^es, Hesion Publishing Co., Inc., 

Reston, Virginia, 1984. 

William B. Sanders, The Elementary Commodore 64, Datamost, Inc.. 
Chataworth, California & Reaton PuWlshing Co., Inc. Reston, Virginia. 1983, 

Weber Systems, Inc. Staff, Commodore 64 t/ser's Mwdbot^ Ballantlne 
Books, New York, New York, 1983. 

Magazine Artli^ 

Atmyl 

Morton Kevelson, "The 1541 Di^ Drive: A Guided Tour*', No. 2, (Febm^ry, 
1984}, pp. 34-38,78. 

Mtohafll ra^nert & Ctevid Banon, "Randtwri Files on the 0-64", No. 3, (March, 
1984), pp. 37-38,76. 

Michael Kleinert & David Barron, "Programming Relative Files", No. 2, 
(February, 1984), pp. 27-28,78. 

Mtehae) Keinsrt & David Barron, "Pfogrammlng Sequential Files"^ No. 1, 
(January, 1984), pp. 67-68, 80-90. 

COMPUTE! 

Robert W. Baker, "Disk Explorer for Commodore", Vol, 5, No. 12, (Dec-, 

1983) , pp. 298-304. 

Jim Butterfield, "Advanced Dtek Logging on the 64", Vol, 6, No. 4, (April, 

1984) , pp. 157-158. 

Jim Butterfield. "Complex Disk Copies for the 64", Vol. 6,No.4,(Apnl, 1984), 
pp. 159-160, 

Jim Butterfield, "Commodore DOS Wedges: An Overview;;, Vol. 5, No. 10, 
(Oct., 1983), pp. 266-270. 
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Jim Butterfield, "Commodore Files for BeginnerSr Part 1", Vol. 5, No. 11, 
(Nov., 1983), pp. 174-182. 

Jim Bulterfteld, "Commodore RIes for Beginners, Part 2", Vol, 5, No. 12, 

(Dec, 1983), pp. 236*240. 

Jim Butterfield, "Commodore Files for Beginners, Part 3", Vol. 6, No. 1, 
(Jan.,1984), pp. 192-194. 

Jim ButterfieW, "Cofflmodof© FBes for Begfnnere, Part 4*', Vol. &, No; 2, 
(Feb.,1984), pp. 165-167. 

Jim Butterfield, "Relative File for the VIC-20 and the Commodore 64j Part 
1", Vol. 5, No. 9. {Sept., 1983), pp. 255-256. 

COMPUTEI'S GAZETTE 

Charles Brannon, "Getting Started with a DisIt Drive, Part 1", Vol, 1, No, 

5, (Novemiatr, 19^), pp. 46-^, 

Charles Brannon, "Getting ^rted with a Disk Drive, Part 2", Vol. 1, No. 

6, (December, 1983). pp. 60-67. 

Charles Brannon, "Getting Started with a Disk Drive, Part 3", Vol. 2, No. 

1, (January, 1984), pp. 66-74. 

Charles Brarinon, "'Getting Started With a Disk Drive, Part 4", Vol. 2, No. 

2, (February, 1984), pp. 44-52. 

Charles Brannon, "Getting Started with a Disk Drive, Part 5", Vol, 2, No. 

3, (March, 1984), pp. 100.108, 163-165. 

Vern Buis, "VIC/64 Program Lifesaver" (Un-new^, Voi. 1, No. 5, 
(November,1983), pp. 132-134, 203, 

Philip Dale, "Disk File Manager", Vol. 1, No. 6, (December, 1983), pp. 
130-132, ^-224. 

Martin Bigert. "File Copier", Vol. 2, No. 6, (June, 1984), p. 118. 

Larry Isaacs, "64 Explorer:Single-Drlve Disk Copying, Part 2", Vol. 1, No. 
3, (September, 1983), pp. 96-100, 123-124. 

Richard Mansfield, "How to Use Tape and Disk Rlea", Vd. 1, No. 4, (Oc- 
tober, 1983), pp. 118-122. 

Wayne Mathews, "Disk Menu", Vol. 1 . No. 2, (August, 1983), pp.BB, 113-114. 

Gerald Sanders, "Disk Purge", Vol. 2, No. 8. (August. 1984), pp.1 10-1 11, 
133-134. 

Bobby Williams, "Power BASIC:Llsinga1S41 DiskDrtve&Comrnodofe64'% 

Vol. 1, No. 2, (August, 1983), p. 90. 

John S. Winn, "Appending Sequential Disk Files", Voi. 2, No. 6, (June, 1984), 
pf».1 20-122. 

RUN 

Robert W. Baker. "Disk Master Revisited", Vol. 1, No. 2. (February, 1984), 
pp.100-108: 
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David Brooks, "It's All Relative", Vol. 1, No. 4, (Aprif, 1084), pp,1 00-107. 

David Brooks. "Relatively Speaking", Vol, 1 , No. 5, (May, 1984), pp.138-140. 

David Brooks, "It's All Relative", Vol. 1, No. 6, (June, 1984), pp. 108-117. 

Michael Bruossard, "Calling Disk Directories to Order", Vol. 1, No. 4, (April, 
1984), pp.122^125. 

Thomas Henry, "DMs^^VtC", Voi. 1. No. 1, (January, 19S4), pp.1 02-1 18. 
GhrlsiDpher Umpton, "Disk Editor 64". Vd. 1 , No, 4, (April, 1984), pp. 71-74. 

Cal Overhulser, "Disk-0-64", Vol. 1, No, 6, (June, 1984), pp. 54-58. 
John Stillwell, "Database Deluxe", Vol. 1, No. 2, (February, 1984}, pp. 40.54. 
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INDEX 



BAM 6 

Bit Access Map: S@e BAM 

BLOCK 6 

Block Allocation Map: See BAM 
Block Availability Map: See BAM 

Bring Back FBes/tMsk — 7 

CHANNEL 

How to Open .....H,.... 15,16 

Reserved 15 

COPY 
Dtsk: See BACKUP 

Disk to Disk , 18 

Same Disk , 15 

Disk to Tape 18 

T3p6 to Disk t i * »^t,»4««> »** ttt**i*it****%t*it*it*i%**t i 4 1 1 1fi 

DIRECTORY 6 

DISK 

Cleaners 5,8 

Density , S,6 

Handling 8,9 

ID Number 7,11 

Structure , 5,6 

DISK DRIVE 

Operation S 

Setup 3 

DOS 5,6 

ERASE 

File: see SCRATCH 

Dye: sm FORMAT 

ERROR CHANNEL 16 

FILE 

CODES: explanation 9 

General Info , 22 

Improper Ck}etng 1 5,16 

PRC (program) ©^10,12,13 

Random '. 23 

Random Access 22 

REL (relative) BAS^ 

SEQ (sequential) , 9,15,22 

USR(user) 9,15,22 

FORMAT 7,11 
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HOWTO: 

Change the Name of a Program See RENAME 

CtMnfeine Two Programs: See MERGE 

Oopy a Program from Tape to disk: . . Ses GOPY Tape to Di$k 

Get Printed Copy of Program , SfeCif^ Channel to 

Prtntsr 

Qel Rid of a Program: See SCRATCH 

UdjoR at a Program: , , , See LIST Program 

Make a Copy of your Disk: r . . See BACKUP 

Make a Copy of your Program: See COPY 

See What's on your Disk: See LOAD Directory 

Turn off the Flashing Red Light: See ERROR CHANNEL 

Prepare a Blank Disk for Us©: See FORMAT 

Us$ a Progrtnn on Youf Diskr — See LOAD Program 

see RUN Program 

HUB 5 

IfilTlALIZE 

omu,... It 

Disk; See FORMAT 
UST 

Directory , , ^ • 10 

Program , , , . , . . , , . . 9,1.0,1 1 

LOAD 

D^ctory , . . 041 

Program: 

RMdy-made Disk 10 

Yoyf Own QmU. , ....... It 

NEW (Disk): See FORMAT 

OPEN Channel to Printer 17 

PATTERN MATCHING 17,18 

RENAME 1§ 

RUN 

Program: 

Ready-made Disk 11 

Your Own Disk 12,13 

SAVE 12,13 

SAVE@0 13 

SAVE and Replace; See SAVE@0 

SCRATCH 7,14 

SECTOR: See BLOCK 

TRACK 5,6 

VALIDATE 15 

VERIFY 1Q,12 

WEDGE 

Qjmmands 19,20 

Loading 19,20 

Running 19 

Why Use It , IS 



WILD-CARD MATCHING: see PATTERN MATCHING 
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AT-A-OLANCe HEFERENCE 



COPY A PILE/PROQRAMi 



CLOSE 15 

or 



type OPEN )'>,n, l5 



PRIN T 1 5, "CO:newfi|e = Otoldflle" 



[RETURN] 
[RETURNI 
[RETURN] 



OPEN 15,8.1S:Pfl!NT#15, "CO:newfile=0toldflle^: 
CLOSE 15 {RETURN] 

COPY TO COMBINE FILES: 

(combine 2 to 4 files) 

type OPEN 15,8.15 [RETURN] 
PR!NT#15. "CO:n9Wfite'=O:oMf^^01,O^olc^file2,O: 
oldflie3,0:olcif|te4" [RETURN] 
CLOSE 15 [RETURN] 

RENAME A FILE: 

(will not work on an open file) 

type OPEN 15,8,15 IRETURN] 
PRINT#15, "RO:n©wname=0;otdname" [RETURN] 



OPEN 15,8,15:PRINT#15, "R0:n6wname = 0:oldname": 
CLOSE 15 (RETURN] 



Bemdmbdr, open ttie error chammi ( 1 5) first and close it last. It automaticat'- 
iy doses your other sequential files when it closes. 



CLOSE 15 



[RETURN] 



or 



